Attorney Docket No. 80168-0237 
Client Matter No. P5800 



UNITED STATES PATENT APPLICATION 

OF 

JAMES X. KONG 
FOR 

TREE STRUCTURE TO PASS DATA VALUES 
TO PREPARED STATEMENT OBJECT 



\\\DC - 80168/237 -#1304693 vl 



1 



Attorney Docket No, 80168-0237 
Client Matter No, P5800 



BACKGROUND OF THE INVENTION 
Field of the Invention 

[0001] The present invention relates to an application programming interface (API), 

and more particularly, to an application programming interface with a tree structure 
to pass data values to a prepared statement object. 
Discussion of the Related Art 
[0002] A JDBC (Java Database Connectivity) provides connection for programs 

written in Java to the data in common databases. The JDBC permits encoding of 
Q access request statements in SQL (structured query language). The SELECT 
rU statement in the SQL statement includes 3 clauses - SELECT, FROM, and WHERE. 
[OOOi] Conventionally, an API uses a string filter to create a SQL WHERE clause as 

Q a string and pass it to persistent object frameworli (POF). Then, in the persistent 
1^^^^ object framework, a JDBC Statement object is used to request a query to get the 
^'"^ result data from a database. The Statement object is an object used for executing a 
simple SQL statement and obtaining the results produced by it. However, the 
Statement object needs to be compiled each time it is being used since it does not 
store the compiled results. 

SUMMARY OF THE INVENTION 
[0004] Accordingly, the present invention is directed to an application programming 

interface (API) that is an improvement of the related art. 
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[0005] Additional features and advantages of the invention will be set forth in the 

description which follows, and in part will be apparent from the description, or may 
be learned by practice of the invention. The objectives and other advantages of the 
invention will be realized and attained by the structure particularly pointed out in the 
written description and claims hereof as well as the appended drawings. 
[0006] To achieve these and other advantages and in accordance with the purpose of 

the present invention, as embodied and broadly described, a method of processing a 
query in a system in an object oriented programming environment, comprising: 
Q using a code to create a condition filter in a standard query language statement, the 
ry condition filter defining properties to be satisfied by a result of the query, and the 

condition filter using an object to execute a precompiled query language statement; 
\i and sending the standard query language statement to a database. 
[000/?3 In another aspect of the present invention, a method of processing a query in 

a system in an object oriented programming environment, comprising: using an 
application programming interface (API) to create a standard query language (SQL) 
WHERE clause statement in a SQL statement and to pass the SQL WHERE clause 
statement to a persistent object frameworls: (POF); and sending the SQL statement to 
a database, wherein the SQL WHERE clause statement includes a condition filter and 
uses a PreparedStatement object to request the query. 
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[0008] In another aspect of the present invention, an application programming 

interface (API) for a database query system in an object oriented programming 
environment, the application programming interface adapted to effect the steps 
comprising: creating a condition filter for a standard query language (SQL) WHERE 
clause statement; and passing the condition filter to a persistent object framework, 
wherein the SQL WHERE clause statement uses a Prep are dStatement object to 
request a query. 

[000^1 In another aspect of the present invention, a computer program product 

!□ comprising a computer useable medium having computer readable code embodied 

ilJ 

therein for a database query, the computer program product adapted to effect the 
steps comprising: making a connection with a database; using a code to create a 
%.} condition filter in a standard query language statement, the condition filter defining 
i'^^^^ properties to be satisfied by a result of the query, and the condition filter using an 
^ object to execute a precompiled query language statement; and sending the standard 
query language statement to the database. 
[0010] In another aspect of the present invention, A computer program product 

comprising a computer useable medium having computer readable code embodied 
therein for a database query, the computer program product comprising: means for 
using a code to create a condition filter in a standard query language statement, 
means in the condition filter for defining properties to be satisfied by a result of the 
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query, and means in the condition filter for using an object to execute a precompiled 
standard query language statement. 
[0011] It is to be understood that both the foregoing general description and the 

following detailed description are exemplary and explanatory and are intended to 
provide further explanation of the invention as claimed. 

BRIEF DESCRIPTION OF THE DRAWINGS 
[0012] The accompanying drawing, which is included to provide further 

j5 understanding of the invention and is incorporated in and constitutes a part of this 
Q specification, illustrates an embodiment of the invention and together with the 
\^ description serves to explain the principles of the invention. In the drawing: 

sea 

[001$] The figure is a block diagram showing database access with an interface 

%i according to the present invention. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

Q 

Reference will now be made in detail to the preferred embodiment of the 
present invention, examples of which are illustrated in the accompanying drawings. 

The figure illustrates database access with the API (application programming 
interface) of the present invention. 

The figure shows a Java application, an API of the present invention, a 
database, and a JDBC for connecting the Java application to the database. The API 
of the present invention creates a condition filter for SQL WHERE clause statement 
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that uses a JDBC PreparedStatement object in a persistent object framework 
(POF). The PreparedStatement object is an object that represents a precompiled 
SQL statement. The SQL statement is pre-compiled and stored in the 
PreparedStatement object. Thus, the PreparedStatement object can be used to 
efficiently execute the statement multiple times. The SQL statement contained in 
the PreparedStatement object can take one or more parameters as input arguments 
(IN parameters). The IN parameter is a parameter whose value is not specified 
when the SQL statement is created. The PreparedStatement object has a question 
mark ("?") as a placeholder for each IN parameter. An application has to set a value 
for each question mark in a PreparedStatement object before executing the 
PreparedStatement. The PreparedStatement object has the potential to be more 
efficient than the Statement object because it has been pre-compiled and stored for 
future use. For that reason, a SQL statement that is executed many times may be 
created as a PreparedStatement object to increase efficiency. 

The classes for the API of the present invention are described now. 
CXPFilter class: This class is a base class to construct the condition filter for 
SQL WHERE clause to be used to create a JDBC PreparedStatement object. The 
data values in conditions will be replaced with and the corresponding data value 
list will also be created. The order of data values in the list is the same as the order of 
in the WHERE clause. Therefore, it is easy to use PreparedStatement.set( ) 
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functions to set the data values. This class uses a tree data structure to store 
conditions internally. Following are characteristics of the CXPFHter: 

• Types of condition operators: !=, >, <, >=, <= 

• Types of condition column values: String, Integer, Long, Boolean, 

BigDecimal, Date 

• Type of LIKE condition operation: LIKE 

• Types of null checking functions: IS NULL, IS NOT NULL 

• Types of case functions: UPPER, LOWER, INITCAP 

• TO„DATE function: TO_DATE 

• Types of logic operations: AND, OR 

• Formats of conditions: 

Normal condition: 

• <column__name>condition_operator<column_value> 

• <t able_name . column_name>condition_op er ator <column__value> 
Like condition: 

• <column__name>LIKE<matching_j)attern> 

• <table_name.column_name>LIKE<matching_pattern> 
Null checking condition: 

• <column_name>IS NULL 

• <table_name.column_name>IS NULL 
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• <column_name>IS NOT NULL 

• <table_name.column_name>IS NOT NULL 
Case function condition: 

• case_function(<column_name>) condition_operator 
case_function(<colunin_value>) 

• case_function(<table_name.column_name>) condition_operator 
case_function(<column__value>) 

TO_DATE function condition: 

• <column_name> condition_operator TO_DATE 
(<column_value>j <date_format>) 

• <table_name.column_name> condition_operator 
TO_DATE(<column_value>, <date_format> ) 

• Class API: 

public class CXPFHter 
{ 

// Condition operators 

static public final String COND_OPER_EQUAL = "="; 

static public final String COND_OPER_NOT_EQUAL = "! ="; 

static public final String COND_OPER_GREAT = ">"; 

static public final String COND_OPER_LESS = "<"; 

static public final String COND_OPER_GREAT_EQUAL = ">="; 

static public final String COND_OPER_LESS_EQUAL = "<="; 

//Null operators 

static public final String NULL_OPER_NULL = "IS NULL"; 
static public final String COND_OPER_NOT_NULL = "IS NOT 
NULL"; 
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//Logic operators 

static public final String LOGIC_OPER_AND = '^AND"; 
static public final String LOGIC_OPER_OR = "OR"; 

//Case fiinction name 

static public final String CASE_FUNCTION_LOWER = "LOWER"; 
static public final String CASE_FUNCTION_UPPER = "UPPER"; 
static public final String CASE_FUNCTION_INITCAP - "INITCAP"; 

public String getFilterStringForPreparedStmt ( ) throws CXException; 

//Traverses the condition tree and return a filter string with 
// replacing the corresponding data values for WHERE 
// clause for JDBC Prep are dStatement object, 

public string getFilterString ( ) throws CXException; 

// Used for debugging only. It traverses the condition tree 
// and return a filter string for WHERE clause. Comment the 
// statement where calls this function after you finish 
// debugging. Otherwise, it will impact the performance of the 
// application, 

public ArrayList getValueList ( ) throws CXException; 

// Traverse the condition tree and return a data value list. 
// The order of data values in the list is the same as the 
// order of in the WHERE clause. 



CXPNormalFilter class: The CXPNormalFilter is a derived class of the 
CXPFilter. This class constructs a normal condition filter for SQL WHERE clause 
to be used to create a JDBC PreparedStatement object. None of parameters in the 
CXPNormalFilter can be null. The characteristics of the CPXNormalFilter are as 
follows: 
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• Types of condition operator: !=, >, <, >=, <- 

• Types of condition column values: String, Integer, Long, Boolean, 
BigDecimal, Date 

• Format of condition: 

<column_name>operator<column_value> 
<table_name.column__name>operator<column_value> 

• Class API: 

public class CXPNormalFilter extends CXPFilter 
{ 

public CXPNormalFilter (String columnName, String operator, Object 
value) throws CXException; 

} 

• Note that none of the parameters can be "null". 

CXPLikeFilter Class: The CXPLike Filter is another derived class of the 
CXPFilter. This class constructs a LIKE condition filter for SQL WHERE clause to be 
used to create a JDBC Prep are dStatement object. None of parameters in the 
CXPLikeFilter can be null. The characteristics of the CPXLikeFilter are as follows: 

• Types of condition operators: LIKE 

• Types of condition column values: String 

• Format of condition: 

<column_name>LIKE<matching_j)attern> 
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<table_name.column_name>LIKE<matching_pattern> 

• Class API: 

public class CXPLikeFilter extends CXPFilter 
{ 

public CXPLikeFilter (String, columnName, String pattern) 
throws CXException; 

} 

• Note that none of the parameters can be "null". 

CXPIsNullFilter Class: The CXPIsNuUFilter is another derived class of 
CXPFilter. This class constructs a IS NULL condition filter for SQL WHERE clause 
to be used to create a JDBC Prep are dStatement object. None of parameters in the 
CXPIsNullFilter can be null. The characteristics of the CPXIsNuUFilter are as 
follows: 

• Types of IS NULL functions: IS NULL, IS NOT NULL 

• Format of condition: 

<column_name>IS NULL 
<table_name.column_name>IS NULL 
<column_name>IS NOT NULL 
<table_name.column_name>IS NOT NULL 

• Class API: 

pubUc class CXPIsNullFilter extends CXPFilter 
{ 
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public CXPIsNuUFilter (String columnName, String operator) 
throws CXException; 

} 

• Note that none of parameters can be "null". 



[0022] CXPCaseFilter Class: The CXPCaseFilter is another derived class of 

CXPFilter, This class constructs a case condition filter for SQL WHERE clause to be 
used to create a JDBC PreparedStatement object. None of parameters in the 
CXPCaseFilter can be null. The characteristics of the CPXCaseFilter are as follows: 

• Types of condition operators: =, !=, >, <, >=, <= 

• Types of case function: UPPER, LOWER, INITCAP 

• Tj^es of condition column values: String 

• Format of condition: 
case__function(<column_name>) condition_operatorcase_function 

(<column_value>) 
case_function(<table_name.column_name>) condition_operator 
case_function (<column_value>) 

• Class API: 

public class CXPCaseFilter extends CXPFilter 
{ 

public CXPCaseFilter (String, columnName, String operator, 
String value, String caseFunc) throw CXException; 

} 

• Note that none of parameters can be "null". 
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CXPToDateFilter Class: The CXPToDateFilter is another derived class of 
CXPFilter. This class constructs a To_DATE condition filter for SQL WHERE clause 
to be used to create a JDBC PreparedStatement object. None of parameters in the 
CXPToDateFilter can be null. The characteristics of the CPXToDateFilter are as 
follows: 

• Types of condition operators: =, >, <, <= 

• Types of condition values: String 

• Format of condition: 

<column_name> condition_operator TO_DATE 

(<column_value>,<date„format>) 
<table_name.column_name> condition_operator TO_DATE 

(<column_value>, <date_format>) 

• Class API: 

public class CXPToDateFilter extends CXPFilter 

{ 

public CXPToDateFilter (String columnName, String operator, 
String dateStr, String dateFormat) throws CXException; 

} 

• Note that none of parameters can be "null". 

CXPLogicFilter Class: The CXPLogicFilter is another derived class of 
CXPFilter. This class constructs a logic condition filter for SQL WHERE clause to be 
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used to create a JDBC Prep are dStatement object. The characteristics of the 
CXPLogicFilter are as follows: 

• Types of logic operators: AND, OR 

• Format of condition: <filterl> logic_operator <filter2> 
. Class API: 

public class CXPLogicFilter extends CXPFilter 

{ 

pubhc CXPLogicFilter (CXPFilter, filterl, String operator, 
CXPFilter filter2) throws CXException; 

S } 

[002S| CXPQuery Class: The CXPQuery is also used in the API discussed as the 

related art. In the present invention, a line "void setFilter (CXPFilter, filter);" is 
added to the CXPQuery used in the API discussed as the related art. 
[002^3 Following are examples for using the API of the present invention. 

Example 1 

• Target 

Create a filter using all data value types: 

((((employee. name = 'John* OR employee.name = 'George') AND 
(employee.age < 30 OR employee.birthday> 17 Jul 1971')) AND 
(employee.salary > 100000 OR employee. bouns > 20000)) AND 
employee, married = 0) 

• Code 

CXPContext context = CXRequestContext.getPOContext ( ); 
CXPQuery query = context.createQuery ("employee"); 
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String namel = "John"; 

String name2 = "George" 

Integer age = new Integer (30); 

Date birthday = new Date ("17 Jul 1971"); 

Long salary = new Long (100000); 

BigDecimal bonus = new BigDecimal (20000); 

Boolean Married = new Boolean (false); 

CXPFilter filterl = new CXPNormalFilter ("employee.name", 

CXPFilter . COND_OPER_EQUAL, name 1) ; 
CXPFilter filter2 = new CXPNormalFilter ("employee.name", 

CXPFilter COND_OPER_EQUAL, name2) 
CXPFilter filter3 = new CXPLogicFilter (filterl, 

CXPFilter.L0GIC_0PER_0R,filter2); 

filterl = new CXPNormalFilter ("employee.age", 

CXPFilter.COND_OPER_LESS,age); 
filter2 = new CXPNormalFilter ("employee.birthday", 

CXPFilter.COND_OPER_GREAT, birthday); 

CXPFntermter4 = new CXPLogicFilter (filterl, 

CXPFUter.L0GIC_0PER_0R,filter2); 
CXPFilterfilter 5 = new CXPLogicFilter (filterS, 

CXPFilter.L0GIC_0PER_AND_,filter4); 

filterl = new CXPNormalFilter ("employee.salary", 

CXPFilter.COND_OPER_GREAT, salary); 
filter2 = new CXPNormalFilter ("employee bonus", 

CXPFilter.COND_OPER_GREAT, bonus); 
filters = new CXPLogicFilter (filterl, CXPFilter.LOGIC_OPER_OR, filter2) 
filter4 = new CXPLogicFilter (filterS, CXPFilter.LOGIC_OPER_AND, filterS) 

CXPFilter filter = new CXPLogicFilter (filter4, 
CXPFilter.LOGIC_OPER_AND, filterl); 

System. out .println ("filter: " + 

filter. getFilterString ( )); // Remove it after debugging!!! 
System.out.println (filterPS: " + 

filter.getFUterStringForPreparedStmt ( )); // Remove it after 

debugging!!! 

15 



-80168/237- #1304693 vl 



Attorney Docket No. 80168-0237 
Client Matter No. P5800 



query, set Filter (filter); 
query .begin ( ); 

• Output 

filter ((((employee. name = *John' OR employee.name ~ 'George') AND 
(employee.age <30 OR employee.birthday>'Sat Jul 17 00:00:00 PDT 
1971')) AND (employee.salary > 100000 OR employee ,bonus>20000)) 
AND employee. married = 0) 

filterPS: ((((employee.name = ? OR employee.name = ?) AND 
(employee. age<?OR employee. birthday>?)) AND 
(employee.salary>?OR employee. bonus>?)) AND 
employee.married = ?) 

Example 2 

• Target 

Use the new API with UPPER function in 

actrasrc/modeles/oms2/com/netscape/oms2/common/UnitConvEngine. 
java. 

• Original code 

CXPContext unitContext = CXRequestContext.getPOContext( ); 
CXPQuery query = unitContext.createQuery ("unit"); 

query.setNativeFilter ("code = ' " + code + + " and 
( (owner_handle = "' + ownerjd + " ') " + " OR 
(UPPER (owner_handle) = UPPER Csystem@0')) )"); 

query.begin ( ); 

• New code 

CXPContext.unitContext = CXRequestContext.get.Context ( ); 
CXPQuery query = unitContext.createQuery ("unit"); 
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CXPFilter filterl = new CXPNormalFilter ("owner_handle", 

CXPFilter.COND_OPER_EQUAL, owner _id); 
CXPFilter filter2 = new CXPCaseFilter ("owner_liandle", 

CXPFilter.COND_OPER_EQUAL, "system@0", 

CXPFilter. CASE_FUNCTION_UPPER); 
CXPFilterS filterS = new CXPLogicFQter (filterl, 

CXPFilter.L0GIC_0PER_0R,filter2); 

filterl = new CXPNormalFater ("code", 

CXPFilter.COND_OPER_EQUAL, code); 
filter2 = new CXPLogicFilter (filterl, CXPFilter.LOGIC_OPER_AND, 

filers); 

System.out.println ("filterPS: " + 

filter2.getFilter.StringForPreparedStmt ( )); // Remove it after 
debugging!!! 

query.setFilter (filter2); 

query .begin ( ); 



• Output 

(code = ? AND (owner_handle = ? OR 

UPPER (owner_handle) = UPPER (?))) 



Example 3 

• Target 

Use the new API with TO_DATE function in 
Price List. getPriceListRows ( ) in 

actrasrc/modeles/oms2/com/netscape/oms2/pricing/PriceList.java. 



\\\DC - 80168/237 -#1304693 vl 



17 



Attorney Docket No. 80168-0237 
Client Matter No. P5800 



• Original Code 

CXPContext poContext = CXRequestContext.getPOContext ( ); 
CXPQuery query = poContext.createQuery ("price_list_row_view"); 

Calendar cal = Calendar. getlnstance ( ); 

String dateString = new SimpleDateFormat ("yyyy-MM-dd hh:mm:ss") 
.format (cal.getTime ( )); 

query.setNativeFilter ("price_list_header_id = " + 

String. valueOf (headerld) + " AND is_active = " + 
String. valueOf(OMSData.DB_TRUE) + 

" AND NVL (effective_date, TO_DATE ('0001-01-01 00:00:00', 'YYYY- 
MM-DD HH24:MI:SS'))" + 

"<=TO_DATEC " + dateString + " "YYYY-MM-DD HH24:MI:SS')" + 
'• AND NVL (expiration_date, TO_DATE ('4712-12-31 23:59:59', 'YYYY- 
MM-DD HH24:MI:SS'))" + 

" > TO_DATE ('" + dateString + " ', 'YYYY-MM-DD HH24:MI:SS')" + 
"AND pricingjdentifier = '" + pricingldentifier + " ' "); 
query.begin ( ); 



• New Code 

CXPContext poContext = CXREquestContext.getPOContext ( ); 
CXPQuery query = poContext.createQuery ("price_list_row_view"); 

Calendar cal = Calendar, getlnstance ( ); 

String dateString = new SimpleDateFormat ("yyyy-MM-dd hh:mm:ss") 
.format (cal.getTime ( )); 

Boolean isActive = new Boolean (true); 

CXPFilter filterl = new CXPNormalFilter (price_list_header_id", 

CXPFilter.COND_OPER_EQUAL, String.valueOf (headerld)); 

CXPFilter fdter2 = new CXPNormalFilter ("is_active", 
CXPFilter.COND_OPER_EQUAL, isActive); 

CXPFilter filter3 = new CXPLogicFilter (filterl, 
CXPFilter.L0GIC_0PER_AND,filter2); 
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String column = "NVL (effective_date, TO_DATE ('0001-01-0100:00:00', 

'YYYY-MM-DD HH24:MI:SS'))"; 
filterl = new CXPToD ate Filter (column, "<=", date.String, "YYYY-MM-DD 

HH24:MI:SS"); 

filter2 = new CXPLogicFilter (filterS, CXPFilter.LOGIC_OPER_AND, filterl); 

column = "NVL (expiration_date, TO_DATE ('4712-12-3123:59:59', 'YYYY- 
MM-DD HH24:MI:SS'))"; 

filterl = new CXPToDateFilter (column, ">", dateString, 
"YYYY-MM-DD HH24.MI:SS'); 

filters = new CXPLogicFilter (filter2, CXPFilter.LOGIC_OPER_AND, filterl) 

filterl = new CXPNormalFilter ("pricing_identifier", 

CXPFilter.COND_OPER_EQUAL, (pricingldentifier); 
filter2 = new CXPLogicFilter (filter3, CXPFilter.LOGIC_OPER_AND, fHterl) 

System.out.println ("filterPS: " 4- 

filter2.getFilterStringForPreparedStmt ( )); // Remove it after 
debugging!!! 

query. setFilter (filter2); 
query .begin ( ); 



• OUTPUT 

((((price_list_header_id = ? AND is_active = ?) AND 

NVL (effective_date, TO_DATE ('0001-01-0100:00:00', 'YYYY- 
MM-DD HH24:MLSS')) <= 

TO_DATE (?, 'YYYY-MM-DDHH24:MI:SS')) AND 

"NVL (expiration_date, TO_DATE ('4712-12-3123:59:59', 'YYYY- 
MM-DD HH24:MI:SS')) > 

TO_DATE (? 'YYYY-MM-DDHH24:MLSS')) AND pricingjdentifier = ?) 

By using the API of the present invention, an application performance for 
database accessing can be improved since the PreparedStatement is used. Moreover, 
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with the API of the present invention, different SQL WHERE clauses can be easily 
formed, thus a flexible JDBC can be provided. 
[0028] It will be apparent to those skilled in the art that various modifications and 

variations can be made in the application programming interface (API) of the present 
invention without departing from the spirit or scope of the invention. Thus, it is 
intended that the present invention covers the modifications and variations of this 
invention provided that they come within the scope of any claims and their 
equivalents. 

-as-, 
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